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IBM Bank Teller Business Component 4.0.3 

This document contains detailed information about version 4.0.3 of IBM Bank Teller Business Component, 
Enterprise Edition and IBM Bank Teller Business Component, Workgroup Edition, including system requirements 
and prerequisites. 


New in this release 

The following additions and enhancements were made since the previous release of the Bank Teller Business 
Component. 

IFX Messages and Transactions (IFX Teller) 

Database tables 

The Bank Teller Business Component provides a set of DDL fdes that create and populate the database tables with 
sample data. 


Cash Drawer Management 

The cash drawer static specifications are now in separate XML files (one per branch). The service definition file 
(dsesrvce.xml) contains definitions that point to these files. 


Branch Administration steps 

The following operation steps are new in this release: 

• CheckUserStatusStep (com.ibm.dse.appl.bas.ifx.CheckUserStatusStep) checks that the user has a status of 
initialized. 

• CheckBranchOpenStep (com.ibm.dse.appl.bas.ifx.CheckBranchOpenStep) checks that the branch is 
open. Operations containing steps that require an open branch must execute the CheckBranchOpenStep 
before executing the other steps. 

• GenerateDocNumberStep (com.ibm.dse.appl.bas.ifx.GenerateDocNumberStep) generates identifiers for 
documents such as the teller exchange start transaction. 

• CDMInitXMLStep (com.ibm.dse.appl.cdms.lnitializeXMLStep) processes the XML file containing the 
static specifications for the branch’s cash drawers. 

New messages 

• Initialize User In Branch Transaction <tllr.InitializeUserRq/Rs> This message initializes a user for 
a branch. The system uses it immediately after signon request to identify the branch to which a user is 
signing on (as the teller system should allow a defined user to signon to any of the financial institution 
branches in a transparent way) and initialize all user data for that branch such as cash drawers and 
limits. 

• Totals Query <tllr.Totals!nqRq/Rs> 

• Cash Drawer Modify Transaction <tllr.CashDrwrModRq/Rs> 

• Temporary Signoff transaction <SignoffRq/Rs> 
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• User End Of Day Sign-off <tllr.Signof£Rq/Rs> 

• Cash Tray Query Transaction <CashTraylnqRq/Rs> 


Modified aggregates 

The Payment Record Aggregate <tllr.PmtRec> has been modified. Refer to the message specification for the new 
implementation of the aggregate. 


Documentation 

The product documentation includes both HTML and PDF documents, which are accessible through the online 
information system. The online information follows the IBM-approved online information architecture and can be 
installed on a local machine or viewed directly from the CD-ROM. 

To use the online information system, you must have a Java-supported Internet browser. For the PDF documents, 
you need a copy of Acrobat Reader 3.02 or higher. 


Migration 

This document describes the steps to take when migrating between different versions of WebSphere Business 
Components Composer. These steps do not apply to new installations. 

Upgrade the Development Workbench from 4.0 PTF5 to PTF6 

To properly update the Development Workbench in Composer 4.0 PTF5 to PTF6, you must do the following 
procedures: 

Update the users table with a new column 

1. Start DB2. From the Tools menu, open the Control Center and then open the Command Center. 

2. For each user workspace, do the following: 

a. Select the Interactive radio button. Connect to the user workspace by entering the following into the 
connection text area: 

connect to <workspace_name> user <workspace_owner> using 
<workspace_owner_password> 

where you replace <workspace_name>, <workspace_owner>, and <workspace_owner_password> 
with the appropriate values for your workspace. 

b. Select the Script radio button. Select Script and then select Open. 

c. Browse to the addUserDataColumnToUsersTable.sql file in the 
install_directory\dwinstall\UpdateFROMPTF5toPTF6 directory and select it. 

d. Click Execute. This creates a new users table field. 

3. For each shared repository, do the following: 

a. Select the Interactive radio button. Connect to the user workspace by entering the following into the 
connection text area: 

connect to < repos itory_name> user <repository_owner> using 
<reposi tory_owner_password> 

where you replace <repository_name>, depository _owner>, and depository _owner_password> with 
the appropriate values for your workspace. 

b. Select the Script radio button. Select Script and then select Open. 
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c. Browse to the addUserDataColumnToUsersTable.sql file in the 
install_directory\dwinstall\UpdateFROMPTF5toPTF6 directory and select it. 

d. Click Execute. 

4. Exit from DB2 


© Copyright IBM Corp. 1998, 2001 



Solve a repository problem of previous version 

1. Execute the RepositoryUpdate.cmd contained in the install_directory\dwinstall\UpdateFROMPTF5toPTF6 
directory. 

2. Connect to the shared repository. 

3. For each workspace, do the following steps: 

a. Version all the definitions (entities, instances, and groups) in the workspace. 

b. Drop the tables of the workspace from the DB2 Control Center. To do this, select all of the tables, right 
click one, and click Drop from the pop-up menu. 

c. Execute the user_management.cmd file contained in the install_directory\dwinstall\ directory. 

d. Select the workspace user and click Edit. Click Create workspace option to recreate the workspace. 

e. Import the definitions you need to each workspace from the repository. 

Update the default contents (predefined groups, entities, and instances) of the Development Workbench 
Note: you only need to do this procedure if you want the latest definitions 

1. Open the Development Workbench and create a temporary user workspace. 

2. In the Repository Explorer, click Add to Workspace from the Workbench menu. Add the entire model 
contained in the version 4.0e shared repository. 

3. Exit the Development Workbench. 

4. Start DB2. From the Tools menu, open the Control Center and then open the Command Center. 

5. Select the Interactive radio button. Connect to the temporary user workspace by entering the following into 
the connection text area: 

connect to <workspace_name> user <workspace_owner> using 
<workspace_owner_password> 

where you replace <workspace_name>, <workspace_owner>, and <workspace_owner_password> with the 
appropriate values for your workspace. 

6. Select the Script radio button. Select Script and then select Open. 

7. Browse to the dw_repDefsUpdateFromPTF5.sql file in the 
</«,vta//_r//recfory>klwinstall UpdatcFROMPTF5toPTF6 directory and select it. 

8. Click Execute. This updates the temporary workspace with the new default contents. 

9. Exit the DB2. 

10. Start the Development Workbench and connect to the new user workspace. Open new editions of all the 
entities, groups, and instances. 

Tip: create open editions for all the entities first to complete this step quicker. 

11. Version the new editions to the shared repository. The recommended name is 4. Of. 

12. Delete the temporary workspace. 

13. For each user workspace, add the contents of the shared repository. This upgrades the user's data from 
PTF5 to the default values of PTF6. 

14. Review any validation errors that the upgrade may have caused. These validation errors are caused by 
changes in the data definitions. 


Hardware and Software Requirements 

For the hardware and software requirements, see the Installation Guide or the General Information Manual. 
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Notices 


This information was developed for products and services offered in the U.S.A. 

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your 
local IBM representative for information on the products and services currently available in your area. Any 
reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, 
program, or service may be used. Any functionally equivalent product, program, or service that does not infringe 
any IBM intellectual property right may be used instead. However, it is the user’s responsibility to evaluate and 
verify the operation of any non-IBM product, program, or service. 

IBM may have patents or pending patent applications covering subject matter described in this document. The 
furnishing of this document does not give you any license to these patents. You can send license inquiries, in 
writing, to: 

IBM Director of Licensing 
IBM Corporation 
North Castle Drive 
Armonk, NY 10504-1785 
U.S.A. 

The following paragraph does not apply to the United Kingdom or any other country where such provisions 
are inconsistent with local law: 

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION “AS IS” 
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT 
LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR 
FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties 
in certain transactions, therefore, this statement may not apply to you. 

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the 
information herein; these changes will be incorporated in new editions of the publication. IBM may make 
improvements and/or changes in the product(s) and/or program(s) described in this publication at any time without 
notice. 

Any references in this information to non-IBM Web are provided for convenience only and do not in any manner 
serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this 
IBM product and use of those Web sites is at your own risk. 

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring 
any obligation to you. 

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of 
information between independently created programs and other programs (including this one) and (ii) the mutual use 
of the information which has been exchanged, should contact: 

IBM Canada Ltd. Laboratory 

B3/KB7/8200/MKM 

8200 Warden Avenue 

Markham, Ontario, Canada L6G 1C7 

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of 
a fee. 

The licensed program described in this document and all licensed material available for it are provided by IBM 
under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent 
agreement between us. 

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained 
in other operating environments may vary significantly. Some measurements may have been made on development- 
level systems and there is no guarantee that these measurements will be the same on generally available systems. 
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Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of 
this document should verify the applicable data for their specific environment. 

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and 
represent goals and objectives only. 


COPYRIGHT LICENSE: 

This information contains sample application programs in source language, which illustrates programming 
techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any 
form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs 
conforming to the application programming interface for the operating platform for which the sample programs are 
written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or 
imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample 
programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing 
application programs conforming to IBM's application programming interfaces. 


Trademarks and service marks 

The following terms are trademarks of International Business Machines Corporation in the United States, or other 
countries, or both: 

AIX 

CICS 

DB2 

DB2 Universal Database 

e-business 

IBM 

LANDP 

MQSeries 

OS/2 Warp 

OS/390 

RS/6000 

VisualAge 

WebSphere 

Lotus, Domino, Lotus Notes, and Notes Mail are trademarks of the Lotus Development Corporation in the United 
States, other countries, or both. 

Java and all Java -based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in 
the United States, other countries, or both. 

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United 
States, other countries, or both. 

MMX, Pentium, and ProShare are trademarks or registered trademarks of Intel Corporation in the United States, 
other countries, or both. 

UNIX is a registered trademark in the United States, other countries, or both and is licensed exclusively through 
X/Open Company Limited. 

Rational Rose is a registered trademark of Rational Software Corporation. 

Other company, product, and service names may be trademarks or service marks of others. 


© Copyright IBM Corp. 1998, 2001 


6 


End of document 



